-
Notifications
You must be signed in to change notification settings - Fork 408
Pattern Pages: Show link to "Read This First" just after the H1 on each pattern page #3320
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
read-this-first.html
appears from APGread-this-first.html
appears on from APG
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good to me
The ARIA Authoring Practices (APG) Task Force just discussed The full IRC log of that discussion<jugglinmike> Topic: Issue 3293: Adding "Read This First" link to the top of each pattern page<jugglinmike> github: https://github.com//pull/3320 <jugglinmike> Matt_King: Everything looks good, here. We have all the necessary reviews, so thanks to everyone for that <jugglinmike> Matt_King: This work is tricky to merge, though, because it requires coordination between two repositories <jugglinmike> howard-e: This patch can land before the corresponding pull request to the "build" repository. Still, I would advise not to merge this until that review is complete <jugglinmike> Matt_King: When the review is complete there, can you comment on this issue and say that it's safe to merge? <jugglinmike> howard-e: Sure <jugglinmike> Matt_King: Great. I think this is really good. I think it's a very positive change. |
@howard-e are we ready for this to land yet? |
read-this-first.html
appears on from APG
@mcking65 the related build repo PR#422 has been approved so this PR is ready to be merged. |
Closes #3293
Additionally, this PR ensures the pages that
/content/shared/templates/read-this-first.html
appears on is controlled from this repository with the new/shared/js/read-this-first.js
script. That was being done fromw3c/wai-aria-practices
by manually adding the template into the patterns and practices index pages. This was discussed in Jul 22, 2025 TF meeting.The script is doing the same by inserting the template content after the first
h1
found on the page.This PR means the insertion from
w3c/wai-aria-practices
should be removed. Note that this should be reviewed and merged before w3c/wai-aria-practices#422 is merged.WAI Preview Link (Last built on Tue, 19 Aug 2025 16:56:44 GMT).